home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / AHIGHVAL.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  56 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _AHighVal( axArray ) --> xHighVal
  8.  
  9. PARAMETERS:
  10.  
  11. axArray : array of CHAR, DATE, or NUM elements
  12.  
  13. SHORT:
  14.  
  15. Get the highest VALUE from an array of chars, numerics or dates.
  16.  
  17. DESCRIPTION:
  18.  
  19. _AHighVal() returns the highest value from an array of Character
  20. Strings, Dates or Numerics.
  21.  
  22. ALL elements must be of the same type! If the array contains mixed elements,
  23. a run-time error will occur.
  24.  
  25. If the array in not CHAR, DATE, or NUM, the return value is NIL
  26.  
  27.  
  28.  
  29.  
  30. NOTE:
  31.  
  32. See also:
  33.  
  34. _ALowVal() which returns the lowest value from an array.
  35.  
  36. _ALowElement() which returns the element number associated with the
  37. lowest value.
  38.  
  39. _AHighElement() which returns the element number associated with the
  40. highest value.
  41.  
  42. EXAMPLE:
  43.  
  44. LOCAL aArray := { 1,5,3,9,12,7 }
  45. t = _AHighVal( aArray )
  46.  
  47. Result: t = 12
  48.  
  49.  
  50. LOCAL aArray := { 'Wallace', 'Jones', 'Taylor', 'Abdul'  }
  51. t = _AHighVal( aArray )
  52.  
  53. Result: t = 'Wallace'
  54.  
  55. ******************************************************************************/
  56.